home *** CD-ROM | disk | FTP | other *** search
/ Giga Games 1 / Giga Games.iso / net / hack / 2_3 / readme.org < prev    next >
Encoding:
Text File  |  1993-06-20  |  10.0 KB  |  260 lines
  1.  
  2.     This file consists of all previous README files for the game, as
  3. released with the original version (Jay F.), first usenet version (Andries B.),
  4. and PC-Hack (Don K.).  This way "README" is current for this version.
  5.  
  6.                         Mike Stephenson
  7.  
  8. -- Original README file --------------------------------------------------------
  9.  
  10. This is export hack, my first semester programming project.
  11.  
  12. To set it up for your system, you will have to do the following:
  13.     1: create a hack uid, to own the top ten list, etc.
  14.     2: create a hack directory "/usr/lib/game/hack" is the default.
  15.     2.5: make the directory 700 mode.    /* sav files go in there...*/
  16.     3: modify hack.main.c to use the new directory.
  17.     4: modify hack.main.c so it uses the new hack gid.  Gid accounts can
  18. go into magic mode without the password, can get cores with ^G, etc.
  19. (make sure gid isn't checked anywhere else...)
  20.     5: recompile hack.
  21.     6: put it in games after making it set-uid hack.
  22.     8: fix the bugs I undobtedly left in it.
  23.     9: tell me what you think of it.
  24.  
  25.     Hack uses the UCB file /etc/termcap to get your terminal escape codes.
  26. If you don't use it, you will have to make extensive changes to hack.pri.c
  27.  
  28. If you find any bugs (That you think I don't know about), or have any
  29. awesome new changes (Like a better save (One that works!)), or have ANY
  30. questions, write me
  31.         Jay Fenlason
  32.         29 East St.
  33.         Sudbury Mass.
  34.             01776
  35.  
  36. or call me at (617) 443-5036.  Since I have both a modem and a teen-age
  37. sister, Good Luck.
  38.  
  39.  
  40. Hack is split (roughly) into several source files that do different things.
  41. I have tried to fit all the procedures having to do with a certain segment
  42. of the game into a single file, but the job is not the best in the world.
  43. The rough splits are:
  44.  
  45. hack.c        General random stuff and things I never got around to moving.
  46. hack.main.c    main() and other random procedures, also the lock file stuff.
  47. hack.mon.c    Monsters, moving, attacking, etc.
  48. hack.do.c    drink, eat, read, wield, save, etc.
  49. hack.do1.c    zap, wear, remove, etc...
  50. hack.pri.c    stuff having to do with the screen, most of the terminal
  51.         independant stuff is in here.
  52. hack.lev.c    temp files and calling of mklev.
  53.  
  54. Because of the peculiar restraints on our system, I make mklev (create
  55. a level) a separate procedure execd by hack when needed.  The source for
  56. mklev is (Naturaly) mklev.c.  You may want to put mklev back into hack.
  57. Good luck.
  58.  
  59. Most of hack was written by me, with help from
  60.         Kenny Woodland (KW)    (general random things including
  61.             the original BUZZ())
  62.         Mike Thome    (MT)    (The original chamelian)
  63.     and    Jon Payne    (JP)    (The original lock file kludge and
  64.             the massive CURS())
  65.  
  66. This entire program would not have been possible without the SFSU Logo
  67. Workshop.  I am eternally grateful to all of our students (Especially K.L.),
  68. without whom I would never have seen Rogue.  I am especially grateful to
  69. Mike Clancy, without whose generous help I would never have gotten to play
  70. ROGUE.
  71.  
  72. -- Hack 1.0.x README file ------------------------------------------------------
  73.  
  74. Hack is a display oriented dungeons & dragons - like game.
  75. Both display and command structure resemble rogue.
  76. (For a game with the same structure but entirely different display -
  77. a real cave instead of dull rectangles - try Quest)
  78.  
  79. Hack was originally written by Jay Fenlason (at lincolnsudbury:
  80.  29 East St., Sudbury Mass., 01776) with help from
  81.  Kenny Woodland, Mike Thome and Jon Payne.
  82. Basically it was an implementation of Rogue, however, with 52+ instead of 26
  83.  monster types.
  84. The current version is more than thrice as large (with such new features as
  85.  the dog, the long worms, the shops, etc.) and almost entirely rewritten
  86.  (only the display routines are the original ones - I must rewrite these
  87.  too one day; especially when you are blind strange things still happen).
  88.  
  89. Files for hack:
  90.     hack        The actual game
  91.     record        Top 100 list (just start with an empty file)
  92.     news        Tells about recent changes in hack, or bugs found ...
  93.             (Just start with no news file.)
  94.     data        Auxiliary file used by hack to give you the names
  95.             and sometimes some more information on the
  96.             objects and monsters.
  97.     help        Introductory information (no doubt outdated).
  98.     hh        Compactified version of help.
  99.     perm        An empty file used for locking purposes.
  100.     rumors        Texts for fortune cookies.
  101.             (Some of these contain information on the game,
  102.             others are just plain stupid. Additional rumors
  103.             are appreciated.)
  104.     hack.sh        A shell script.
  105.             (We have hack.sh in /usr/games/hack and
  106.             hack in /usr/games/lib/hackdir/hack and all the other
  107.             hack stuff in /usr/games/lib/hackdir - perhaps this
  108.             will make the script clear.
  109.             There is no need for you to use it.)
  110.     READ_ME        This file.
  111.     Original_READ_ME Jay Fenlason's READ_ME
  112.  
  113. System files used:
  114.     /etc/termcap    Used in conjunction with the environment variable
  115.             $TERM.
  116.     /bin/cat
  117.     /usr/ucb/more
  118.     /bin/sh        Used when $SHELL is undefined.
  119.  
  120. How to install hack:
  121. 0. Compile the sources. Perhaps you should first look at the file config.h
  122.    and define BSD if you are on a BSDtype system,
  123.    define STUPID if your C-compiler chokes on complicated expressions.
  124.    Make sure schar and uchar represent signed and unsigned types.
  125.    If your C compiler doesnt allow initialization of bit fields
  126.    change Bitfield. When config.h looks reasonable, say 'make'.
  127.    (Perhaps you have to change TERMLIB in the makefile.)
  128. 1. If it didnt exist already, introduce a loginname `play' .
  129. 2. The program  hack  resides in a directory so that it is executable
  130.    for everybody and is suid play:
  131.     ---s--s--x  1 play    206848 Apr  3 00:17 hack
  132.    Perhaps you wish to restrict playing to certain hours, or have games
  133.    running under nice; in that case you might write a program play.c
  134.    such that the program play is suid play and executable for everybody
  135.    while all the games in /usr/games are readable or executable for
  136.    play only; all the program play does is asking for the name of a game,
  137.    checking that time-of-day and system load do not forbid playing,
  138.    and then executing the game. Thus:
  139.     -r-sr-sr-x  1 play     13312 May 24 12:52 play
  140.     ---x------  1 play    206848 Apr  3 00:17 hack
  141.    If you are worried about security you might let play do
  142.    chroot("/usr/games") so that no player can get access to the rest
  143.    of the system via shell escapes and the likes.
  144.    If you #define SECURE in config.h then hack will not setuid(getuid())
  145.    before executing a chdir(). Hack will always do setuid(getuid()) with
  146.    a fork. If you do not define UNIX then hack will not fork.
  147. 3. The rest of the stuff belonging to hack sits in a subdirectory hackdir
  148.    (on our system /usr/games/lib/hackdir) with modes
  149.     drwx------  3 play    1024 Aug  9 09:03 hackdir
  150.    Here all the temporary files will be created (with names like xlock.17
  151.    or user.5).
  152. 4. If you are not really short on file space, creating a subdirectory
  153.    hackdir/save (modes again drwx------) will enable users to save their
  154.    unfinished games.
  155.  
  156. The program hack is called
  157. $ hack [-d hackdir] [maxnrofplayers]
  158. (for playing) or
  159. $ hack [-d hackdir] -s [listofusers | limit | all]
  160. (for seeing part of the scorelist).
  161. The shell file hack (in this kit called hack.sh) takes care of
  162. calling hack with the right arguments.
  163.  
  164. Send complaints, bug reports, suggestions for improvements to
  165. mcvax!aeb - in real life Andries Brouwer.
  166.  
  167. -- PC Hack 3.51 README file ----------------------------------------------------
  168.  
  169.     Welcome to the sources for PC HACK (version 3.51).
  170.  
  171. Introduction
  172. ------------
  173. This is a version of the public domain program HACK 1.03 (copyright
  174. Stichting Mathematisch Centrum, Amsterdam, 1984, 1985.) implemented
  175. under MSDOS with the Microsoft(tm) C v3.0 compiler.
  176.  
  177. You may copy this version of PC HACK and make any changes you want to
  178. it.  You may give it away, but you may not sell it.
  179.  
  180.  
  181. The sources are in ARC format in HACK351S.ARC.  The commands:
  182.  
  183.     C> arc51 e hack351s makefile make.*
  184.     C> arc51 e hack351s *.h
  185.     C> arc51 e hack351s *.c
  186.  
  187. will unpack the files.
  188.  
  189. With a hard disk system, you should be able to type `make' and the sources
  190. will start to be compiled.  This takes a long time.  A floppy disk system
  191. does not really have enough storage.
  192.  
  193.  
  194. Compiling
  195. ---------
  196. The LARGE compiler model is used.  To add WIZARD mode, add a -DWIZARD
  197. to the MAKEFILE, or a #define WIZARD to the CONFIG.H file.
  198.  
  199. The MAKEFILE included with PC HACK 3.51 sources is for my version of MAKE.
  200. It is very similar to UNIX(tm) `make'.  See MAKE.DOC for details.
  201.  
  202. To compile the sources by hand the command for each `filename.c' file is:
  203.     msc -AL -DREGBUG -DLINT_ARGS -Ot -Gs filename.c;
  204.  
  205.  
  206. Linking
  207. -------
  208. I used the Microsoft 8086 Linker version 3.01
  209.  
  210. To link the *.obj files by hand, the command is:
  211.     link @linkfile
  212.  
  213. Where the contents of the linkfile (not supplied) should be:
  214.  
  215. decl.obj apply.obj bones.obj cmd.obj do.obj +
  216. do_name.obj do_wear.obj dog.obj eat.obj +
  217. end.obj engrave.obj fight.obj hack.obj +
  218. invent.obj ioctl.obj lev.obj main.obj +
  219. makemon.obj mhitu.obj mklev.obj mkmaze.obj +
  220. mkobj.obj mkshop.obj mon.obj monst.obj +
  221. o_init.obj objnam.obj options.obj pager.obj +
  222. potion.obj pri.obj read.obj rip.obj +
  223. rumors.obj save.obj search.obj shk.obj +
  224. shknam.obj steal.obj termcap.obj +
  225. timeout.obj topl.obj track.obj trap.obj +
  226. tty.obj unix.obj u_init.obj vault.obj +
  227. wield.obj wizard.obj worm.obj worn.obj +
  228. zap.obj version.obj rnd.obj alloc.obj +
  229. msdos.obj 
  230. hack /NOIG /STACK:4000; 
  231.  
  232.  
  233. Differences from UNIX HACK
  234. --------------------------
  235. Changes that were introduced to port UNIX HACK to the MSDOS environment
  236. are surrounded with `#ifdef MSDOS', `#endif' directives.
  237.  
  238. Other changes I have made are surrounded by `#ifdef DGK', `#endif'
  239. directives.  It should be possible to compile these sources without
  240. any of my changes by removing the `#define DGK' line from CONFIG.H.
  241.  
  242. Also, functions I have added are mainly restricted to the file msdos.c,
  243. although some of them are in other places (ie. wizard.c)
  244.  
  245.  
  246. Finally
  247. -------
  248. If you have any questions, contact me at one of:
  249.  
  250.     Don Kneller
  251.     UUCP:    ...ucbvax!ucsfcgl!kneller
  252.     ARPA:    kneller@ucsf-cgl.ARPA
  253.     BITNET:    kneller@ucsfcgl.BITNET
  254.     USMAIL:    D. G. Kneller
  255.         2 Panoramic Way #204
  256.         Berkeley, CA 94704
  257.  
  258. --------------------------------------------------------------------------------
  259. END OF FILE
  260.